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SIG NEWS 


The TECO SIG (Special Interest Group) has been quite active 
during the last year. Perhaps our best accomplishment was 
the creation of a TECO reference card. This pocket guide 

is in three colors and covers all TECO's available from DEC. | 
The reference card is now available from the SDC (Software 
Distribution Center). Its order number is AV-D53(@A-TK. 


We have held sessions at each MINI/MIDI DECUS symposium . 
Since the SIG's creation. Our TECO Tutorials (held at each 
‘symposium) have always greeted large audiences (standing room 
only). . 


At the Spring '79 Symposium, we hope to bring down several 

new versions of TECO for distribution. (Media will most likely 
be MAGtape and DECtape.) It is hoped that we will have 

TECO-11 -version 34 available for RSX, VAX, and RSTS. Two new 
TECO's, one for OS/8 and one for TOPS-1%8 will be available 
(hopefully). These versions have been written at the prompting 
of the SIG and should be compatible with TECO-11. More news 
about these versions of TECO will be given in the next issue 

of the Moby Munger. . 


There will be at least one TECO paper given at the Spring 
Symposium. 

There is also a Birds of a Feather Session scheduled, so 

users are urged to prepare small talks to be given there. 


If you are not already a member of the TECO SIG, send your 
request for membership (it's free) to 


DECUS 

MR2-3/E55 

One Iron Way 
Marlboro, MA 01752 


The Moby Munger is published sporadically by the TECO SIG. 
Articles are needed. We especially need macros of interest. 


Also, anyone interested in helping out with SIG administrative 
work should write to the TECO SIG, c/o DECUS at the above 
address. We need someone to help catalog and solicit and 
review TECO submissions to: the DECUS program library and we 

- need someone to help organize activities at and solicit papers 
for DECUS symposia. 


The SIG would also appreciate hearing information about other 
versions of TECO available. Also, we coordinate bug reporting 
and bug fixing for various versions of TECO that are not offi- 
Cially supported by DEC. Send all bug reports and other 
comments or suggestions to the TECO.SIG, c/o DECUS or to the 
editor. . 
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NOTES FROM RT-11 


RT-11 V3B included TECO-11 (version 28) as an unsupported 
product. Users of that version of TECO should be warned that 
later versions of TECO-11 have made some changes that may 
affect existing macros. The CTRL/W window command was changed 
to W and the Qq command no longer throws away any numeric 
argument. Users should plan ahead to the time that a later 
version of TECO-11 is available for RT-1ll. (Some users may 
have received version 29 at a DECUS symposium.) 

Current plans are that version 34 of TECO-11 will be released 
with version 4 of RT-1l. That release is currently scheduled 
for early in 198%. The delay is because the TECO maintainers 
are too busy with the RT-11 release to find time to upgrade 
TECO. 


If any reader who is a user of RT-11 would like to volunteer 

to upgrade TECO-11 for RT-11, send your name and qualifications 
in to the TECO SIG (c/o DECUS). The lucky winner will receive 
the source of the RT-11 TECO I/O module along with the new 

I/O interface spec and an OBJ of the main TECO kernel. 


NOTE ON VT52 SUPPORT 


Users trying to use the VT52 support macro under CTS-39% or 
the FB version of RT-11 must a aware that they must first 
issue the command 


SET TT: NOCRLF 
to the operating system. 


NOTES FROM VAX 


Version 29 of TECO-11 was included with the first VAX-11/780 
release as an unsupported product. The manual is available 
from DECUS (DECUS-11-35@). We have been using version, 33 
-in-house at DEC for quite a while now and it seems very solid. 
We hope to be able to submit this version to the DECUS library 
very shortly. 


PROBLEM WITH CTRL/C 


The CTRL/C immediate action command (in VAX TECO v29) does not 
properly get you out of TECO. Temporarily, you can use the 
CTRL/Y command to abort TECO, but this alternative has the 
disadvantage that you. .may be left with an unwanted g-length 
file if you had a file open when you aborted. The way you 

can avoid this is to type EK$$ before doing the CTRL/Y, or by 
using the +Zt+Z+Z command. CTRL/C has been fixed in v33. 


PROBLEM WITH TECO.TEC 


TECO.TEC will not work properly if you aie using sub- 
directories under VAX. This problem has been fixed and a 
hew TECO.TEC has been created and tested and hopefully will 
Shortly be available from the DECUS program library. 
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NOTES FROM 0S/8 


TECO is a supported product running under the OS/8 operating 
system. Version 5 was released with OS/8 V3D (as part of the 
extension kit). This version will also run under OS/78, 
although it will not run properly while a symbiont is running. 
The PDP-8 group at DEC has no plans to re-release TECO in the 
near future. 


INDEX TO PUBLISHED PATCHES: 


Seq. DSN 
Number issue 


31.28.01 Mar 78 CHANGING THE DEFAULT EU VALUE 
Gives an optional patch to change 
the initial value of the EU flag. 


31.26.92 ‘Mar 78 CHANGING THE DEFAULT EH VALUE 
Gives an optional patch to change 
the initial value of the EH. flag. 


31.28.03 Mar 78 REMOVING YANK PROTECTION 
Gives an optional patch for users who 
don't like Yank protection. This 
causes the Y and - commands to always work. 


31.20.84 Mar 78 SCOPE SUPPORT FOR VT£{5 USERS 
| Gives an optional patch to allow command 
line scope editing to work from VTQ#5 
terminals. 


31.28.85 Mar 78 PROBLEM WITH AY COMMAND 
Fixes bug: Y command sometimes aborts 
‘with ?NYA error (such as after an A 
command) even though no numeric argu- 
ment is specified. : 


31.28.06 Mar 78 CONDITIONALS INSIDE ITERATIONS 
| Fixes bug having to do with nesting 
of conditionals and iterations. 


31.28.87 Mar 78 ECHOING OF WARNING BELLS 
Fixes TECO so that the warning you get 
when about to run out of command line 
Space consists only of a bell ring and 
no accompanying "“G" (Caret~G) typeout. 


31.20.88 May 78 CTRL/U SOMETIMES FAILS AFTER * 
Fixes many bugs having to do with scope 
editing and typing rubouts and CTRL/U's 
after a * has been entered into command 
string. 
31.29.16 May 78 MULTIPLYING BY @ IN TECO 
Fixes bug: n*§f didn't always return Q. 


31.28.11 May 78 Q-REGISTERS DON'T WORK IN 8K 
Fixes bug. Enables Q-Register commands 
to work properly on 8K machines. 


Title/Description 
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seq. DSN 
Number issue 


31.28.12 May 78 CAN'T SKIP OVER A “w" 
Fixes bug: While scanning fora ', 
TECO would blow up if it encounters 
a W command or a PW command. 


31.28.13 Jul 78 UNSPECIFIED ITERATIONS AFTER INSERTS 
Fixes bug. An iteration with an un- 
specified iteration count would some- 
times act as if the iteration count 
' was @ (thereby skipping the iteration). 
For example, IAS<...> exhibits this 
behavior. 


31.28.14 Aug/Sep 78 NEW FEATURES IN TECO V5 
Describes the complete set of differ- 
ences between TECO V4 and V5. 


21.83.81 May 78 DEFAULT EXTENSIONS TO TECO 
, , Gives an optional patch to V3D CCL 
to cause the TECO and MAKE commands 
to use .MAC as the default estension 
rather than .PAL . 


Title/Description 


_ KNOWN RESTRICTIONS : 


The following bugs are known to exist in OS/8 TECO and should 
be considered to be permanent restrictions. .There are no plans 
now or in the future to fix these bugs.. 


1. No error message is given if the nI command is not 
followed by an ALTMODE. Use of such a construct inside 
a conditional will cause unpredictable results. 
Way around: akways follow nI command by an akltmode. 


2. If an ALTMODE is typed into TECO in response to a’ tT command, 
TECO will return the ASCII code for a dollar sign (decimal 
36) rather than the correct decimal 27. 

Way around: Turn echo off f4rs5t. This bug does not manifest 
Athelf when echo 4b off. 


3. A large T or X command will abort with the ?FUL error if 
the output device is nearly full. | 
Way around: issue T oA X command in smaller pieces on exit TECO, free 
up space on output device and then resume editing. 


4. The CTRL/S special command: (freezes type-out) turns off 
' the window display on a PDP-12. 
Way atound: After typing CTRL/Q, the window display nesumes. 


5. Typing CTRL/C while I/O is going on to a non-system device 
may cause TECO to return to dot rather than to prompt. 
Way around: Avotd typing CTRL/C while such 1/0 4% in progress. 


6. TECO will die if while running under BATCH in 12K or 16K 
machines, TECO attempts to read from BAT: . 
Way around: Avoid use of BAT: handler on such configurations. 
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CORRECTIONS TO OS/8 HANDBOOK UPDATE . 


The OS/8 Handbook Update (DEC-S8--OSHBA-A-DN4) contains much 
new information about TECO. New features of TECO' version 5 
are reported. There are a number of errors in table 2-45 
(on page 24) which describes TECO's error messages. 
Specifically, the one-line error message for some errors 

is incorrect. The error code and corrected messagé appear 
below: 


Error Message 


?BNI > not in iteration 
| ?PUL | Output command would have overflowed output device 
? NFO No File for Output | 

?SNI ; Not in an Iteration. 

?XAB Execution Aborted by CTRL/C 


Also, it should be noted that each occurrence of X* in the 
error message listing should really be "x" . This represents 
the fact that TECO will substitute the character in error for 
"x". For example, the command FA will produce the error 
message: ?IFC Illegal Character "A" after F . 


WILD. TEC 


The program WILD.TEC was distributed with the OS/8 TECO 
material that was handed out at the last DECUS meeting. 

For those of you who did not get it, it is reprinted on the 
following page. It is useful only with the new CCL that is 
distributed with the latest version of OS/78. (That is the 
CCL that allows multiple-character switches.) That CCL will 
‘run under OS/8 as well as OS/78 and is highly recommended for 
use by all OS/8 users. It has the special feature that if a 
COMPILE, PAL, MACRO, or EXECUTE command is issued with a 
filespec that contains wildcards, then SYS:TECO.TEC is in- 
‘ yoked passing it the user's command string in the text buffer. 
WILD.TEC parses the command and creates the appropriate BATCH 
stream to properly execute the command. Thus, you can type 


-MAC *.MAC 


and OS/8 will assemble all files with a .MA extension on DSK:. 
Similarly, the command 


~-COMPILE .ABC??? .FT 
will assemble all FORTRAN programs whose names begin with the 


letters ABC. If you don't have the new CCL, the above 
command can be issue by typing MUNG WILD,COMPILE ABC???.FT . 
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SYSTEM MACRO TO KAWNDLE WILD CARDS] 


BAUD QGatrt tn $Get first character in buffer 

we FOTHE J D HT : JIf «t {8 “Ty type message following!) 
lfollowed by a CR/LF] 

sd W land exit] , , 


1I1f first character is not “T or ",4) 
Ithen assume a command linel 
. fia in the buffer, | 
$"8$ R UXA GK lStore the verb in Qereg Al 


JI 

[Surround the filesnpecs by CR/LF3! 
<JLSwSp,e1ULS"SS $ POL,.X1 Qise.K SL2RGi> [Move al] = switches to front! 
SJLS/Sp,e1UIS7SS &$ RQ1,,X1 Q1,,K ALeRGI> !Move all / switches to fromtih — 


L @R @XB @LK IGet atl switches into Q=reg 8} 
$JOB 
IR WILD,DI«<§& {Create BATCH preface! 
eR I/Frh 
JNG WILD,"$ GA I"$ GB 
SEND 
[Create BATCH ernilog! 
NILD,TMPS PW EF HK !Put created BATCH Job im WILD, TMP] 
SUBMIT WILD,TM/T/HS ” JExecute the BATCH Job} 
ee iE lIf the first character is a" | 
> F8"S § {then delete it & ehange matching " to space} 
k @K HXB HK Iplace pre=text im G=reg A and postetext in BI 
WILD,OISY . ; lRead im directory listing of files that matched] 
ZJ #3K Idelete garbage at beginning and end! 


=“ANo such files 
: IGive error message if no files remaining! 
"§ 83> | [Removes spaces from filespecs! 


eR OxC GB @L I,% GA ICreate COMPILE FILE command) 
-I,MUNG WILD,°TS GC I 
; {Create TYPE command! 
lRepeat, for each fillesrec! 
iJOB 
ING WILD, *TSGAT3 
II,R FOTP 
LO SDI,KILD,TMeWILD,&I/D 
iD 
{Put BATCH template sround commands) 
ILD, BIS Pw EF HK Create second BATCH Job! 
'UBMIT WILD/T/HS lExecute itl 
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NEW TECO FOR 0S/8 


A new TECO for OS/8 will shortly be submitted to the DECUS 
program library. It is called TECO~-8 and is based on DEC's 
OS/8 TECO V5. It was written by Stan Rabinowitz and is 
upward compatible with DEC's TECO. It is written in MACREL 
and contains many new extensions to DEC's TECO, mostly 
compatible with TECO-11. Copies will be available at the 
next symposium. | 

Of most interest is the fact that it contains VT support 
(written by Jim Roth). This support is compatible with 
TECO-11's VT support and allows maintaining a window into the 
text buffer.on the screen of a VT${5, VT52, or VT1£Q. 


Also of interest is TECO.INI and TECO.TEC support, read with 
no wait, CTRL/C trapping, War and Peace Error Message Mode 
(3EH), type-ahead, V, "A and "D, and much much more. More 
details will appear in the next Moby Munger. An advance 
article appears on pages 7-1f of the January 1979 issue of 
The 12-Bit SIG Newsletter (issue #32). | 


PREVIEW OF VTEDIT 


With the above-planned release of TECO-8 will be a macro 
called VTEDIT.TEC . It is compatible with TECO-11's VTEDIT 
that is a superset of the VT52.TEC macro. This macro turns 
TECO into a true scope editor. The buffer is permanently 
displayed on the scope of the CRT. Typing a character 
immediately enters it into the buffer and .updates the screen. 
Typing special keys and keys on the VT52 keypad cause special 
actions to occur. A summary of the keypad layout follows: 
(See page 54 for corresponding layout for the -11l version) 


Cursor 
rigitt* 


Cursor 
left* 


“Cc... .. Return to TECO 
‘Dp... . Killrest of line* 
“K . » Kill line * 

‘U... .. Killstartofline | 
“Z... . Return to TECO 


BK SP . . Go to end of line* 
DELETE . Delete previous character* 
ESC ESC. Repeat RED-key command* 


All *commands take an optional argument as: 
ESC number 
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NOTES FROM TOPS-12 


TECO is a supported product running under the TOPS-19 
operating system. The latest. release is version 24 (292) 
which was released in March of 1977. 


This version of TECO is pretty solid, however it does not 

' contain any scope support, nor has this TECO kept pace with 
the other TECO's around DEC. For these reasons, many 
DECSYSTEM-1@ users are running versions of TECO written at 
places other than DEC. 


The TECO SIG hopes to remedy this situation shortly by 
submitting to DECUS a new version of TECO for TOPS-19 that 
will be compatible with TECO-1] and will have scope support. 
This version is being worked on by Andy Nourse and we hope 
to have it available from the DECUS program library very 
shortly now. Copies should be available by the next -19 
DECUS symposium. 


Bug reports for DEC's TECO should be submitted on SPRs in 

the usual manner. Fixes are published periodically in the 
Software Dispatch. . Following is a complete summary of all 
published corrections to TECO since the release of version 24 
(edit 292): 


Index to TECO Revisions 


Edit SPR-no. / PCO-no. Description of bug fixed 


date 
283 18-23364 -51 TECO does not generate correct line 
oO sequence numbers when the /GENLSN 
19-Aug-77 switch is given as part of an 
: EB command 
284 18-23588 -£52 TECO generates erroneous errors such 
as ?FNF if the trace feature 
14-Sep-77 (? command) is turned on. 
295 19-21631 -§53 A ?NNQ error is given when trying to 
access a Q-register with a Q command 
15-Sep-77 after an illegal argument to a U 
command has been given. 
218 1-21632 -54 Successful searches within iterations 
do not return a value of -1. 


“14-Oct-77 Editorial note: TOPS-10 users are in for a 
| big shock when they install this fix. 

TECO has been working ‘incorrectly!’ for the 
7 years that T have been using it and all 
TECO programmers know that searches do not 
return values unless they are colon modified. 
The problem 4s that the documentation has 
been urong all these years. TECO-11 made the 
above change several versions ago and 
Ammediateky got Lots of flack from akl their 
users, So they changed back. The algorithm 
found most useful is that a search in an 
Atenration acts as if 4t were colon modified 
44 4t 45 Ammediately followed by a semicolon. 
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Index to TECO Revisions (cont.) 


Edit 


206 
207 
211 

212 
213 
214 


215 


216 


SPR-no./ 
date — 


none 
17-Oct-77 


none 


17-Oct-77 
18-22148 


28-Oct-77 


1808-21417 
G8-Nov-77 


19-21561 
29-Nov-77 


1$-22762 


15-Dec-77 
1f$-24918 


17-Feb-78 


10=25563 
19-Apr-78 
18-25665 
g1-May-78 


10-25395 
@2-Jun-78 


L9-25659 
17-Jul-78 


18-25648 


18-Jul-78 


none 
G5-Sep-78 


PCO“no e 


-955 


~ $56: 
~957 


-$58 
~059 


~f6p 


~661 


- #62 


- 263 
- £64 


-~£65 


$66 


-~267 


Description of bug fixed 


MACRO version 53 gives an' error 
when TECO is compiled. 


TECO gets an illegal memory reference 
if it is loaded with DDT and a command 
line of 9% characters is entered. 


TECO gets an illegal memory reference 
when doing an nXq command if 
> 262114. 


The *q every once in a while puts 
garbage in Q-register q. 


The tEL match control construct fails 
to recognize end-of-buffer as a match. 


TECO is not able to find the file that 
is to be edited when FTSFD is turned 
off. ws . 


Successive searches forget exact case 
specifications. For example, the 
command SatVBS causes the search to 
proceed using exact case mode since 
case control constructs are present. 

A subsequent S$ command uses the pre- 
ceding search argument, but forgets to 
use exact case mode. This patch causes 
the exact mode internal flag to be re- 
set only when an explicit search string 
is given. 


If the 8lst character of a search 


“pattern specification is a CTRL/Q or 


CTRL/R, the first word of the 
Q-Register stack gets wiped. 


Standard page marks are not given in 
line sequence mode. 


TECO gets confused by garbage after 
a filespec when processing CCL. 


No error is given if the match control 
construct CTRL/+ occurs at the end of 
a search string. This patch creates 
the new error message ?MCO (Missing 
Character Operand). 


StE[A,+ES] will match A and any tabs 
or spaces following A. 


This edit improves the comments in 
the source of TECO. 
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Index to TECO Revisions (cont.) 


Edit SPR-no. / PCO-no. Description of bug fixed 
date 
225 1f-26761 -68 The commands MAKE FILE.EXT and 
TECO FILE.EXT lose the third char- 
12-Oct-78 acter of the extension. (Edit 221 
broke the command scanner.) 
226 1f9-26914 -f69 TECO high segment is too big. 
2f-Oct-78 . 
227 18-27219 -$78 © ? sometimes doesn't work after an 
erroneous *q command. Rubout doesn't 


14~Dec-78 work after a *q and *q goes into 
affect after a single ALTmode instead 
of after two ALTMODEs. 
Editorial comment: I believe that *q is an 
Ammediate action command and shoukd go into 
agfect urithout any altmodes being necessary. 


Note: I have not been able to determine the content or purpose 
of edit 217 to TECO. 


Miscellaneous TECO bugs: 


The following bugs were reported to me by a person who wishes 
to remain’ anonymous. He reported them to DEC in November of 
1977 but DEC refused to answer his SPRs since he was a DEC 
employee and not a customer. These bugs apply to v24 of 
DEC's TOPS-18 TECO: 


1. A Fails if buffer is full. 
If a file is open for input and you fill up the text 
buffer to capacity and then issue an A command, TECO 
properly issues the message ?COR - Storage Capacity 
Exceeded, and then proceeds to wipe out the text buffer 
(sets Z=9). 


2. Excessive Pops bomb TECO. 
If a large number of successive pop commands is given, 
for example 5@PG<]q> , TECO aborts with an illegal 
memory reference. TECO ought to give a message such as 
?CPQ Can't Pop Q-register if the Q-register push down 
stack is empty and a ]q command is issued. 


3. Push Down List overflow is fatal to TECO. 

. The command !A!<OAS$ aborts TECO with a ?PDL OV error 
message. TECO ought to be smart enough to catch this 
error andgive an error message such as ?PDO. 


4. Literal-typeout-mode too General 
If the 1ET command is issued to put TECO into ntberai= 
typeout-mode, then many TECO features act strangely. 
For example, while editing a command string, if you try 
to rubout a CTRL/A, TECO retypes the deleted character by 
sending a true CTRL/A (rather than an uparrow-A) to the 
terminal. Also, the Bell-space immediate action command 
retypes the line literally, and error messages such as PIFC 
report erroneous characters literally. This is wrong. 
Only TECO typeout should be affected by literal mode (see 
section 3.6.4 of the TECO manual). 
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5. TECO fails to recognize ta . 
Erroneous results can occur if the CTRL/A command is 
used in its uparrow mode within an unsatisfied con- 
Gitional and the "a" following the uparrow is in lower 
case. For example, the command . 


B"N<P"Nta text ees 


produces the ?MAP error message incorrectly. 
The above command works if ta is replaced by es ae 


6. Null FS: replacements abort command. 
The command IABCDSJFSBStVSTSS doesn't execute the final 
T command since TECO thinks it has seen a double ALTMODE 
and consequently aborts the execution of the command 
-string after replacing B by the null string. 


7. @-modifier to tab confuses TECO. 
The TECO documentation fails to specify that the 
tab and tI commands may be @-sign modified. Such commands 
appear to work. For example, both @+/text/ and @tI/text/ 
insert >text into the buffer. (> denotes a tab character.) 
However, if an @-sign modified tab command appears within 
an unsatisfied conditional, TECO gets confused. For 
example, the command 2"E@tI/L/'SS$ works while the command 
2"E@>/L/'S$ fails giving a ?MAP error. 
‘Suggestion: TECO ought to treat.@> as an error. 


NOTES FROM RSX 


Version 28 of TECO-1l was released (as an unsupported product) 
with versions 3 and 3.1 of RSX-11/M. Version 28 is also in the 
DECUS program library. The order number for the RSX-11/M 
version is DECUS-11-333 and the order number for the RSX-11/D 
version is DECUS-11-334. It is expected that TECO-11 version 
34 will shortly be submitted to the DECUS library. The DECUS 
order number for the manual is DECUS-11-359. sree 


Fixing RUNOFF files 


Output from RSX RUNOFF is in a very strange ASCII format, so that 
RUNOFF output can not be conveniently input to SRCCOM. These 
problems can be fixed up by passing the funny file throguh TECO 
twice as follows: 

TECO file/- CR 

*EXSS$ 

TECO file 

*EXSS 


Bug with P and full buffer 


If the text buffer is full and does not end with a line-terminator, 
and if the form feed flag is not set, and a P command is issued, 
TECO will insert an erroneous carriage-return / line-feed at the 
rend of the buffer. This bug is due to inherent RMS problems 

and there is no plan to fix this bug in future TECO-11 releases. 
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NOTES FROM RSTS/E 


TECO was released with RSTS V6C as an unsupported product. 
Tt has also been distributed at recent DECUS symposia. A new 
version will shortly be put into the DECUS program library. 


NEW FEATURES FOR V29: 


The following new features are part of the version 29 release 
and apply only to RSTS: 


-1. A bug which prevented reading oe certain RMS files has 
been fixed. 


2. The EG command has been changed. The new format is 
EGcommand$ or @EG/command/ 


This command is the same as EC, however control returns to 
RSTS’ and the CCL command specified after the EG command is. 
executed by RSTS. 


3. Several new file switches are permitted on file specifica- 
tions in the ER, EW, and EB commands. oe: 


/Bt+ is the same as the / (with no switch) and means 
that you are editing a BASIC PLUS file. 


/B2° .is a new switch and means that you are editing a 
BASIC PLUS 2 file. It is the same as the /72 
command (see below). . 


/n where n is a decimal number. On input, this causes 
the trailing &'s (along with all preceding spaces 
and tabs) to be'discarded. On output, if a line is 
terminated by a carriage-return / line-feed sequence 
and the next line does not begin with a digit, then 
enough tabs and/or spaces are appended to the line 
followed by an & to cause that & to go into column n 
of the line. If this is not possible, then a single 
space followed by an & is appended. | 


4. The new CCL command 
TECO file2=filel 


has been implemented. It reads filel and creates file2. 
It is equivalent to the TECO command 


ERfilelSEWfile2sy 


5. The TECO start-up file, TECO.TEC, has been modified. 
Users who have their own private copies of TECO.TEC should 
be aware that it will be invoked with a -l in Q-register 1. 


see elsewhere in this issue for general features of TECO v29 
that apply to all TECO-11 implementations. 
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PROBLEM OF THE MONTH 


This column will present interesting and/or unusual problems 
for the reader to solve. 


Problem 1: Write a TECO macro, which, when executed, 
types out the upper case letters A to Z 
(in order) on the terminal. 


Restrictions: 


(a) There must be no other. _type- out by 
this macro. 


(b) The macro must contain only distinct 
characters. That is, no character may 
be repeated. (An upper case character 
is to be considered different from its 
lower case counterpart.) 


The macro must be as short as possible. 


For example, the macro 
LABCDEFGHIJKLMNOPQRSTUVWXYZSht 


is a 38 character solution to the problem. It is far from 
minimal. Can you cut it down to 15 characters or less? 


Solutions should be sent to the editor and must be postmarked 
by June 15, 1979. 


There are two classes of competition: 

CLASS A: Macro is written in machine-independent (DEC) TECO* 
and will run correctly under OS/8, RT-11, RSX-1l1, 
RSTS/E, or TOPS-19. 


CLASS B: Macro is machine dependent. Specify on which TECO 
| it will run. 


Macros will be tested by effectively putting them in 
a file called MACRO.TEC, invoking TECO, and executing 
the command string ERMACRO.TECSYHXMHKMMSS . 


Winners names will be printed in the first issue of the Moby . 
Munger following the conclusion of this contest. 


Solutions and problem proposals for future columns should be 
sent to the editor: Stanley Rabinowitz, 6 Country Club Lane, 
Merrimack, NH 03054. . 


+ Consult TECO reference card for system compatible commands. 
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COMMENTS ON *Z 
by Eric Osman 


The *Z command in TECO-11 is a real crock because 
1) Typing a non-* and then DELETE and then *Z loses. 


2) Sometimes you do a long command string, then a few short 
command strings later (things like HT, etc.) you realize 
the long command string wasn't quite right and you want it 
back. *Z is useless at this point. 


My suggestion for definition of *Z command, where "Z" is any | 
legal Q-register name is: 


The *Z command takes the last command string that was 
longer than 15 characters and stores it in Q-register Z. 


Notes: 


‘ a) The number 15 is arbitrary, but has proven convenient 
in other TECO's. 


b) This definition solves both problems listed above. 


~¢) No conflict with multiplication because * seen with no 
preceeding argument means "save last long command string". 


BEGINNER’S COLUMN 


by Stan Rabinowitz 


Selectively making changes to a file 


A common editing problem is to change all occurrences of 

one string to another ina file. Although the command 
<FNstringl$string2$;> is usually good enough to do this, 
this command has the problem that there might be an unusual 
occurrence of the stringl that shouldn't be changed. The 
following technique is a typical way of avoiding this 
problem. This command string searches for the given stringl 
and types out the line containing this string on the terminal. 
It then waits for the user to type a character on the 
terminal, if he types "Y", then that means that the seatags. 
should be replaced by Stving?: Typing any other character 
means that the stringl should not be replaced in this case. 


<Nstringl$; -Search for string, exit if not found: 
tA 

tA >-Return the carriage! 

OTT ; :Type the current line! 

tA 

Change? +A :Prompt for decision! 
4T-44+Y"E-7DIstring2s' :If yes, replace string! 


> tand continue! 
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DIFFERENCES BETWEEN TECO-11 V29 AND V28: 


1. The ntUqS command was implemented. It inserts the char- 
acter whose ASCII code is n into Q-register q. The 
command may be @-sign modified and colon modified (colon 
means character appends to end of Q-register text). 


2. F_ was put back in. 


3. Several commands were changed to prevent conflicting with 
DEC's TOPS-18 TECO. +W was changed to W (Window command). 
tv (version number) was changed to EO. 


“4. The tR (Replace) command was eliminated. It is identical 
to FS. 7 

(The above two items were necessitated by the fact that the DECsystem- 
10 group upgraded their TECO to version 22 without SEN what 
the PDP-& and PDP-11 groups were doing. } 


Vertical tab is now an error (it used to be ignored). 


6. The tV and tW string build constructs and the tEV and tEW 
match constructs were implemented to be compatible with 
DEC's TOPS-19 TECO version 23. Also, a bug involving the 
"V and "W conditionals was fixed. 


7. ‘The +t string build construct was eliminated. Its func- 
tionality can be accomplished by the new tV construct. 


8. Some error codes were changed for compatibility reasons. 
?ICC became ?IQC and ?IQR became ?IQN. 


9. The :A (append single line to text buffer) command was 
implemented. 


19. An error message is generated if a Y command has a 
numeric argument. — 
(This 45 a good nnotoction feature and is compatible with OS/8& TECO.) 


11. The bits in the EH flag were shuffled so as not to 
conflict with TOPS-12% TECO. The old 3EH is now 4EH. 


12. The bits in the ED flag were shuffled around so that now 
the flag is bit-encoded. -lED is now 2ED. 


13. The <bell><space> and <bell>* commands were modified so 
that the first line of the command string will be pre- 
ceded by an asterisk (representing TECO's prompt). 

‘Now, if you are on a scope terminal and rub out a multi- 
line command string back to the first line, the * prompt 
that was on the screen does not disappear. 


Version 29 of TECO-11 is the version that is documented in the 
TECO Reference card available from the SDC. The PDP-11l 
implementors must be congratulated for their part in ironing 
out incompatibilites between the various TECOs at DEC. The 
only item above that may be of some concern to users is the 
change in the window command. Anyone who wrote scope editing 
macros under v28 should change all CTRL/W's to W's in their 
macros. 
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DIFFERENCES BETWEEN TECO-11 V29 and V32: 
TECO-1l has the following new features that were not in V29: 


1. The Qq command may now take an argument. nQq returns 
the value of the (nt+l)th character in Q-register q. 
The argument n must be between @ and the Q-register's 
Size -1l. If n is out of range, then a value of 
-l is returned. (9Qq returns the first character, etc.) 
(Warning - this new command causes many existing macros to break, 
because many macros were assuming that the Q command would discard 
any angument. It would be a wise programming practice to always 
discard an unneeded value by following <t with an ALTMODE, a 
command which 4s guaranteed to discard any argument. } 


2. The O command can now build the tag to go to using the 
same constructs as the Search and E commands. Specifically, 
the t+EQq construct can be used. 


3. The EJ command has been implemented. EJ returns your 
job number and 1EJ returns your console keyboard number. 
(g is returned on single-user systems.) 
(Additional EJ commands have been impLemented in Later versions of 
TECO-11; these wikl be described in the next sssue of the moby munger. ) 


4. Conditionals now allow an IF-THEN-ELSE construct. In 
addition to the usual form of a conditional, you now 
have the new form: 


n"X <then-commands> | <else-commands> ' 


If the condition (denoted above by X) is satisfied, then 
the then-commands are executed. If the condition is not 
satisfied, then the else-commands are executed. 

(A neak advance in structured programming in TECO! This command 
4h amazingly useful. Additional commands that will make TECO 
programming mone structured are pkanned for the near future. 

User comments and suggestions are always welcome. ) 


5. The :W command can be used to return scope characteristics. 
@:W returns your scope type. §% means VT52, 2 means VT1@Q, 
4 means VT@5 with fill, and 6 means VT@5 without fill. 
1l:W returns the scope's horizontal size. 2:W returns the 
scope's vertical size. n,m:W is used to set the m:W 
information to n. (This Rast feature seems to Be a Little 
Aneonsrstent with the nest of the Language. ) 


This version of TECO-11 has been in use in-house at DEC for 
quite a while, so it has gotten extensive testing. However, 
it has not yet been made publicly available. Version 34 of 
TECO-11 will shortly be submitted to DECUS. Watch for more 
information. The next issue of the Moby M will contain 
details about version 32, 33, and 34. You can look forward 
to such obscure commands as F',. F<, F>, and hexadecimal radix 
mode! 
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DIFFERENCES BETWEEN TOPS-16 TECO V24 and V23B: 


DEC 
new 


A ie 


's TOPS-1%8 TECO version 24 (edit 202) has the following 


features that were not in version 23B (edit 162): 


TECO now allows editing of files protected via the File 
Daemon. The File Daemon bit (48%) of the file protection 
is preserved in the new files created. 


TECO will now allow ERSATZ devices and SFD's in arguments 
to the MAKE, TECO, ER, EW, and EB commands, as well as 
the "{-]" and "[,]" constructions. . 


On an EB or TECO command, TECO will now always put the 
new source file where the command string specified. 

(In version 23B, the new file always went into the user's 
area.) 


Any time that TECO finds a file on an area other than 
the one explicitly specified in the command string 
(because of scanning up directory paths), the warning 
message %File found in [path] is printed. 


The command MAKE A=B is now permitted. It is equivalent 
to invoking TECO and giving it the initial command 
ERBSEWASYSS . An equal sign in a TECO command will be 
ignored. Thus TECO A=B is equivalent to. -TECO As 

Thus, if a MAKE A=B command is followed by a TECO <crlf> , 
the right thing will happen (the system will remember the 
previous argument, and file A will be edited). 

(Once again the -10 world went and implemented a feature without 


— Seeing how other DEC operating systems handle the feature. 0S/8 
solved this wnobLem severak years prion to the -10's AmpLementation 


The 


(a) 
(b) 


(c) 


by making the TECO A=B command edit B into A and only remember the 
argument up to and not inckuding the "=" sign.) 


following deficiencies in V23B were not corrected in V24: 
CTRL/C REENTER or EX$$ REENTER sometimes results in lost 


editing or address checks. 


Changing the size of the push Gown list causes a garbage 
collect error (?GCE). 


The value output in the [nK CORF] message is not always 
correct for KI processors. 


Presumably, the following bugs in V23B were fixed: 


(i) 


(ii) 


TECO couldn't handle magtape with non-standard block 
size. 


?FUL was incorrectly generated if a file on a DECtape 
was open for both input and output. 


(iii) Output to device NUL: resulted in a superseding warning. 


(iv) 


?COS error was not detected for EB commands. 
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TECO DOCUMENTATION AVAILABLE. FROM DEC 


Since the last issue of the Moby Munger, the following new 
TECO documents have become available from DEC: 


' Order Number ' Description 
DEC-11-UTECA-A-DN1 UPDATE NOTICE No.. 1 to TECO-11 User's 
Guide 


This is an update to the July 1977 
copy of the TECO-11 User's Guide 


(DEC~11-UTECA-A-D). It upgrades 
appendix F (The index to TECO commands 
and special characters). The original 


index had the wrong page numbers. 
This document is also a useful .summary 
of TECO-11 commands (version 28). 


AV-D53A-TK TECO POCKET GUIDE . 


This is a pocket reference card that 
covers OS/8 TECO version 5, TECO-11 
version 29, and TOPS-1%9 TECO version 24. 
It is extremely detailed. Commands 
peculiar to specific implementations 
are easy distinguished by a color 
coding. 


ERRORS IN TECQ REFERENCE CARD 


A few errors have been noticed in the TECO Pocket Guide 
(AV-D53@A-TK). These are described below: 


1. Several commands are in black and imply that they exist 
in all 3 flavors of TECO; however, these commands are not 
implemented in TECO-8. ‘They are: 


' (a) (page 12) [q is not in TECO-8 
(b) (page 11) nES is not in TECO-8 
(c) (page 12) tEA is not in TECO-8 


2. Page 16, the graphic for the character whose octal ASCII 
code is 174 is vertical bar (|) not close square bracket. 


3. Page 17, note [11] should say "Not in RSTS or RSX. ... " 


4, Page 17, note [25] should say "TECO-18 allows begin of 
buffer to match and does not allow ., S$, or % to match" 


Readers discovering other errors in the card are urged to write 
in and inform us so that these errors can be fixed on the next 
printing. ji 
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EDITORIAL - TECO vs. TV 
by the Editor 


As the reader of this newsletter may notice - TECO runs 
on most DEC operating systems: OS/8, RT-1l, RSX-11/D, 
RSX-11/M, IAS, VAX, TOPS~-1@, and RSTS/E. A glance at the 
large number of black entries in the TECO Reference Card 
shows that these TECO's are largely compatible too. 


Of notable absence is the DECSYSTEM-29. Why doesn't TECO 

run on this machine too? Well, in fact it does. Since 

TECO runs under TOPS-19, that version of TECO will run on 

the -28 too in -1@ mode. However, running TOPS-19 TECO v24 
on a -28 is not very convenient because TOPS-1% TECO does 

not support scope terminals and TOPS-28 does. How to get 
around this problem? Since most of the TOPS~-29 developers 
were heavy TECO users from -1f land anyhow, it seemed obvious 
to upgrade TECO to run on the DEC-29 and to support scopes. 
This in fact they did - sort of. Instead of starting with 
DEC's. TECO for TOPS-18, they started with BB&N's TENEX TECO 
(see page 29). After considerable modification and improvement, 
they wound up with a program called TV. TV supports many 
CRTs and looks very similar to TECO. It is currently being 
used guite heavily within DEC by the DEC-29 implementors. 
Unfortunately, since it was not based on DEC's TECO, it has 

a few features that are incompatible with TOPS-1% TECO and 
TECO-11. 


As of the last information that I have (which is about a year 
old), TV contains 61 commands that are exactly the same as 
TECO commands; it contains 19 commands that are extensions to 
TECO; and it contains 1 commands that are either slightly 
different than their TECO counterparts or have different names. 
Clearly, only a little bit of effort could have made TV 
completely compatible with TECO. Right now, TV is a very 
fine editor. However, there are a few commands that it‘has 
that would 'wipe out' experienced TECO users. For example, 
the R command in TV is what the FS command was in TECO. 

I agree that R consists of fewer keystrokes than FS, but for 
the sake of only one extra keystroke, I would rather see a 
compatible TECO on the DEC-22. 


Unless a lot more incompatiblities have been added since my 
last information, the following changes, if made to TV, would 
make it compatible with TECO: | 


Change names of ;R , ;W , ;X , and ;C commands to ER, EW, 
EX, and EC respectively. Change ;-space to ; command. 
Change ;F to _, change F to N, and change R to FS. 


Change the XK command so that it does not delete the characters 
extracted and change the tA command so that the syntax is 
tAtexttA rather. than tAtextS . Rename E command to something oie. 


It seems to me that ER is just as easy to type as ;R, so I don't 
understand why this command was changed. Just a small amount 

of work could turn TV into a beautiful editor compatible with 
TECO, yet still keep its extensions. Why doesn't someone do this? 


Replies to this editorial are actively solicited. 
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HISTORICAL DEPARTMENT 
DIFFERENCES BETWEEN TOPS-1¢ TECO V23B and V23A: 


Lower case FS and FN commands now accepted. 


l. 
2. +S can now match first buffer character. 
3. TECO now recognizes SOS page marks. 

4. 


A warning message is given if a file contains line se- 
quence numbers but no /GENLSN or /SUPLSN switch was 
specified. 


5. TECO now uses the monitor commands TTY ALTMODE and 
TTY NO ALTMODE to determine if altmode conversion should 
take place. 


6. ?NNQ and ?TTL error messages added. 


7. ALTMODE terminating a macro now returns to the next macro 
level rather than reinitializing. 


8. Numeric arguments are now preserved across carriage 
return and line feed. . | 
DIFFERENCES BETWEEN TOPS-1% TECO V23A and V23: 


The only change was that the DATE-75 revision was added in V23A. 


DIFFERENCES BETWEEN TECO-11 V27 and V24: 


The following features were in TECO-11 version 27 which were 
not in version 24: (consult TECO-11 manual for description 
of what these commands do) 

1. scope mode command string editing 

2. secondary input and output streams (EP, ER$, EA,EWS) 

3. wildcards (EN) and indirect input (ETI) 

4. filespecs can use string build constructs such as tEQq 
5. bounded search (m,nStext$ , @,nStext$ , m,Stext$) 

6. . string build constructs: t , tEQ* , and tEQ_ 


7. lq, :Gq , :G* , :G_, and :Qq 
8. EGtexts 
9. m,nD 


18. n"V and n"W conditionals 
11. EV and nEV 


12. ET bits 6, 7, 8, and 15 (detach flag, abort on error, 
truncate to terminal width, and CTRL/C trap) . 


13.. nt+Q TECO command 
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RELATIVE ADVANTAGES AND DISADVANTAGES OF KED AND TECO 
by Tom McIntyre 


KED is a new video text editor for RT-11 which implements a 
proper subset of the proposed DEC Editor Standard. EDT is the 
only other DEC editor related to the standard. The readers of 
this newSletter need no introduction to TECO. The following 
table gives a brief view of what I consider the chief advantages 
and disadvantages of both KED and TECO. . 


TECO 
ADVANTAGES DISADVANTAGES 
Programmable Obscure mnemonics 
Powerful editing commands Limited error recovery 
Expression evaluation Inconvenient file handling 
Generic search types Limited human engineering 
Multiple variables 

KED 
ADVANTAGES DISADVANTAGES. 
Easy to learn No macro capability 
Good error recovery Limited variable facility 
Convenient file handling No hard copy editing 


Good human engineering 


The primary difference I see between KED and TECO is 
philosophical in its basis. KED is designed from the ground up 
as an interactive video text editor. The basic goal of the user 
interface is that one can guess from the function names what any 
effect will be. In those cases where the guess is incorrect, one 
can easily recover in context by using the inverse function. 
TECO on the other hand is basically a text programming language 
and incidentally an interactive editor. One might “properly view 
TECO as text language interpreter which provides an "immediate" 
mode of operation. TECO has had a very long period of 
development and consequently has a very rich set of operations 
and functions. In my view this development has left TECO with 
the disadvaritage of a very obscure set of keywords. 


Although there is no direct relatonship between the editing 
semantics and the file handling capabilities, KED also has a more 
natural file handling system. KED scrolls in the text file with 


no reference on the user's part to edit pages or extents. The 
user is free to move forward or backward to the limits of the 
file. In addition KED can maintain an auxiliary input file and 
an auxiliary output file. In order to rearrange a file with KED 


and put portions of it in an output file, one need only locate to 
the various elements in the order they are wanted and write them 
out. One never needs to close and reopen the input file. The 
most common compound edit operation, the global replace, is 
implemented in KED. It is called the substitute function and can 
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be used either for an automatic global replace or a verify 
interactively and replace. In the global flavor it is equivalent 
to the TECO command: 


<@FN/STRING/STRING/> 


Since TECO is a general text processing language, one can 
implement almost all of KED in TECO. Indeed, the display 
management code in KED is based on Herb Jacob's TECO display 

‘manager. Some of KED's commands are messy to implement in TECO 
and the file handling would require changes to the interpreter. 
KED on the other hand is more efficient since it is a direct 
implementation. 


A KED Emulating TECO macro has been written for TECO-11 
by D. J. Duffy. It is hoped that this will shortly become 
available from the DECUS program library. 


KED has the additional "advantage" of lack of flexibility. KED 
is a fully Supported DEC product and will be maintained as a 
Standard on any systems on which it is implemented. TECO 
Standards on the other hand depend on the continued interest of a 
community of interested users. 


In summary, TECO is far and away the best text processing 
‘language available over the whole range of DEC computers (and 
many others as well). The only way a threat could develop for 
TECO in this area would be for DEC to develop a good SNOBOL for 
"all the systems (an unlikely occurence). KED on the other’ hand 
is unsurpassed for ease of learning and effectiveness in standard 
text editing situations. 
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Keypad Layout for VT100 
Lower Function is GOLD 


” DELLINE 


iY secrion } 


BR Fan f 


EY aovance Pr 


{ sorrow f 


BLINE 


y sececr JA 


OPEN LINE Wo oRESET ff 


DELETE RUB CHAR 

LINEF EED RUB WORD 

CTRL/U RUB LINE 

CTRL/W = SCREEN UPDATE . 
CTRL/Z CANCEL (PROMPTS) 
CTRL/C CANCEL (MOVEMENT ) 


<GOLD>nnn REPEAT ANY FUNCTION 
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[OPEN] INPUT file | ’ Open Auxiliary Input file 


[OPEN] OUTPUT file Open auxiliary output file 
CLOSE Close Auxiliary output file 
PURGE Purge Auxiliary output file 
INCLUDE options Read from input file 
SKIP options Ignore from input file 
WRITE options Write to output file 
options © nnn PAGES Pages as defined 
, nnn LINES Lines 
REST ‘ Remainder of file 
CLEAR PASTE Clear paste buffer 
EXIT Close files and restart editor 
QUIT Purge files and restart editor 
SET [ENTITY] PAGE defn Define a page | 
SET [ENTITY] SECTION defn Define a section 
defn ‘or " string of chars ' or ™ 
nnn LINES 
SET [SEARCH] GENERAL General searches 
SET [SEARCH] EXACT Exact searches 
SET [SEARCH] BEGIN Cursor at beginning of target 
SET [SEARCH] END . Cursor at end of target 
SET [SEARCH] BOUNDED Bound search on PAGE definition 
SET [SEARCH] UNBOUNDED . Searches are not bounded 
SET [SCREEN] 80 Set screen width 
SET [SCREEN] 132 
SET [SCREEN] LIGHT Sereen to reverse background 
‘SET [SCREEN] DARK Sereen to normal background 
SET QUIET Errors do not sound terminal bell 


SET NO QUIET Errors sound terminal bell 
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HARVARD TECO 


This article describes Harvard TECO version 22.5 
which runs on a DECsystem-18. Harvard TECO is based upon 
DEC's TECO for the -1%, version 22. (TOPS-1@ TECO version 
21 was the 'traditional' TECO that OS/8 TECO and TECO-11 
are based on; whereas the current TOPS-1@ TECO by DEC is 
version 24.) Information for this article comes from a 
memo dated May 1972 and is probably considerably out-of- 
date. Recent information about Harvard innovations to 
TECO would be appreciated. Comments in italics are the 
editor's personal opinions. 


1. A new output file may not be opened until an existing 
output file is closed explicitly. 
(A good safety precaution. TECO-11 works this way too.) 


2. Y and commands have been replaced by EY and E_ commands 
respectively. 
(Again, a good sasety feature. However, I Ltke TECO-11's and 0S/8's 
Yank protection algorithm better. ) 


3. Control.characters are permitted in searches and inserts 
just as they were in DEC's TECO version 21. 
(A wise fix. I feel DEC made a mistake when they prohibited control 
characters from insert strings. 1 think that the ony restricted 
characters should be CTRL/E, CTRL/Q, CTRL/R, CTRL/S, and CTRL/X and 
CTRL/N. Future enhancements can all involve CTRL/E constructs so 
as to avodd incompatibilities with existing macros.) 


4, Space is ignored as a TECO command. 
(Very wise. Using Space to mean plus upsets all my ideas of 
neadabikity and good. programming practice. ) 


5. FB bounded search command has been implemented. It takes 
an argument that is the same as the argument allowed on. 
line commands such as K, T, and X. In other words, 

nFBtext$ searches the next n lines 
m,nFBtexts searches between pointer positions 
mand n. 


The original pointer position does not change if the 
bounded search fails. 

(I Like this scheme better than the scheme used by version 29 of 
TECO-11. I 48 easter to remember and use.) 


6. The nFSstringl$string2$ command makes n replacements. 
(This 48 kneompatible with ale the TECOs at DEC. Its functionality 
can easily be achieved with the n< string] $string2$> command. ) 


7. The FC (Find and Change) command is a combination of the 
FS and FB commands. Thus m,nFCaSbS finds the first 
occurrence of "a" between buffer pointer positions m and n 
and replaces it with the string "b". (Neat! } 
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HARVARD TECO (cont.) 


8. 
I 


1p. 


11. 


12 


13. 


14. 


15. 


16. 


17. 


The ntE. command can be used to set the form feed flag. 


The :X command works like an X command but deletes the 
extracted text from the text buffer. In this case, the X 
is mnemonic for Xfer rather than eXtract. 

(Many people believe that this 4s the mone useful option. However, 

I bekieve it would be too devastating to make such a change in 
existing TECOS. Perhaps the thing to do 4s to make <t a user option . 
by putting this facility under the control of some ED bit.) 


Harvard TECO contains a form of the EU command for upper/ 
lower case conversions. However, it has a very strange 
and incompatible syntax, so I won't describe it here. 


Position Recording Arguments (VB, VI, and VS). 

VB is set to the buffer pointer position at the start of 
any search command. Thus, if the search failed, VBJ 
gets you back to where you were. (useful) 

VI returns the value of the buffer pointer position 
immediately before the most recent insert command. 

Thus VI,.K kills an incorrect insert. — 

(The TECO-11 command FRS does the same thing. ) 

VS returns the value of the text buffer position directly 
in front of the string matched by the most recent 
successful search. 


End-of-Line Counting Arguments (VL and VZ). 

VZ is the number of end-of-line characters in the text 
buffer. VL is the number of end-of-line characters 
preceding the current text buffer pointer position. 


Line Formatting Aids (VC and VH). 

vce returns the number of ASCII characters between the 
beginning of the current line and the current pointer 
position. VH is similar to VC but gives special con- 
sideration to characters such as tab, carriage-return, 
and backspace. Thus VH approximates the horizontal 
position of the current pointer on a printed page. 

(The equivalent of WH would be very convenient for the VWEDIT macro. 
TECO-11 might want to dmpLement this via something Like a 0:49 
command. } 


ntO\ inserts the octal representation of n into the text. 
buffer. 
General octak radix mode is a better sokution to. this probLem. ) 


nz; exits an iteration if n is negative. 
(This seems very useful to help writing structured code. ) 


:T command is similar to T command but non-printing char- 
acters have special echo. For example, carriage-return 
types out as <CR> 


: modifier only affects the very next command and would 
not extend across commands until it found a command for 
which it were meaningful. 
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BB&N TECO 


This version of TECO was written by BB&N (Bolt Beranek and 
Newman, Inc.) and runs under the TENEX operating system. 
Some of this information comes from Bill Plummer at BB&N. 
Also, I wish to extend my deepest thanks to James Neeland 
of the Hughes Research Laboratories who sent me a manual. 
This information reflects BB&N TENEX TECO as of October 
1973. 


I ama bit reluctant to call this editor a TECO variant be- 
cause it contains several radical departures from traditional 
TECO. . These changes are extremely inconsistent with all the 
TECOS at DEC. An experienced DEC TECO user would have a lot 
of trouble trying to use this 'TECO'. 


The main incompatibilities are: 


(a) The R command does a replace (it does what the FS command 
does in DEC's TECOs) . 

(ob) A single ALTMODE is the immediate action command that 
means start execution of this command string. In order 
to enter a single ALTMODE into a command string without 
beginning execution, you must use the immediate action 
command CTRL/D which inserts an ALTMODE into the command 

* String. 

(c) For no reason that I have been able to discern, the E 
commands have all been changed to ; commands. Thus, to 
open a file for input, you type ;Rfilespecs . 

EF became ;C , EW became ;W_, etc. 
‘The original ; command is now ; followed by a space (UG H! } 


However, there are enough similarities between this TECO and 
DEC's TECOs, that some of their extensions are worth mentioning. 
The following lists some of its extensions to DEC's TOPS-19 
TECO version 24. My comments are in italics. Reader comments 
"are solicited. 


1. Negative arguments to a search command cause the search 
to proceed backwards. 
(A useful feature; abready in TECO-11.) 


2. A backward search initiated when the text buffer pointer 
is currently at the start of the buffer will automatically 
bring the pointer to the end of the buffer and then the 
search will commence. 


3. A PP repetition count to a search or replace command is 
a no-op. : 


4, EAfilespec$ opens the file for append. 


5. Backspace, if typed as the very first character ina 
command string is an immediate action command that per- 
forms an effective -LTS$ command. Linefeed, if typed as 
the very first character in a command string, is an im- 
mediate action command that performs an effective LTS$ 
command. 

(This feature 44 going into TECO-11.) 
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BB&N TECO (cont. ) 


6. mntH tells TECO what kind of terminal you are running on. 


7. A new Q-register, by the name of @ is defined. It has a 
; special property. If TECO is halted, and the resulting 
core-image is saved, the result is a runnable program. 
When that program is run, it starts up by executing the 
contents of Q-register @, i.e. an effective M@ command 
occurs. This feature is useful Oe creating runnable 
TECO programs. 


8. The command m,nG gets a copy of the (n-m) characters 
beginning with the character after pointer position m 
and inserts it at the current pointer position. 
nG makes a copy of the next n lines leaving the buffer 
pointer between the copies. Gq works as it always did. 
(These commands wreck havoc on TECO'S algorithm for skipping 
commands. A possible use for m,nGq might be to get the mth through 
nth characters from Q-rnegister q into the text buffer. } 


9, The ;P (Pick-up) command performs a 6A command combined 
with a C command, returning the value accessed. 


1@. m,nV types the m-l lines before the current line, types 
the current line, then types the n-1 lines after the cur- 
rent line. nV is the same as n,nV . V means 1V. 

(A nice compatible extension to TECO-11's V command. ) 


CCA TECO 


This version of TECO is a modification of BB&N TECO. It was 
implemented at the Computer Corporation of America in Cambridge 
by someone whose initials are MRC... The following information 
was obtained from Donald Eastlake III and appears to be 

current as of July 1977. The following is a partial list of 
differences between CCA TECO and BB&N TECO: 


1. ALTMODE was restored to its original status. To quote 

from MRC: " The misfortune of using +D for a single altmode and 
altmode for double altmode has been flushed. +tD is now an ordinary 
character, and TECO behaves like every other TECO in the world. 


2. Space, if typed as the very first character in a command 
string, is an immediate action command that performs an 
effective STTSS command. 


3. Carriage-return and line-feed throw away any numeric 
argument preceding them. 


4. ntT types out the character whose ASCII code is n. 
(OS/& TECO and TECO-11 already do this.) 


Documentation also indicates that phase-of-the-moon commands 
will shortly be implemented (I gather to be compatible with 
MIT's TECO.) 


Page 31 


WPI TECO 


WPI TECO (also known as WACCC TECO) was written at the 
Worcester Polytechnic Institute Computer Center and is based 
on DEC's TECO (version 23) for TOPS-18. The following infor- 
mation (current as of April 1977) is based on WPI TECO 
version 23T. Comments in script eyRS are the editor's per- 
sonal comments. 


Ll. . 


EP (Page Control) command added. I don't understand the 
LEP command. 

2EP returns the current page number. 

4EP sets 'truth-in-paging mode'. In this mode,. Y and P 
commands must proceed to form feed characters, expanding 
core as necessary. If this mode is not set, Y and P 
commands may stop when the current buffer is nearly fuil, 
setting the form-feed flag (tE) to # to indicate that a 
partial page has been read in. 

8EP causes the terminal bell to ring (to wake you up ) upon 
the completion of a search or P command. 

16EP causes the EB command to create a .OLD backup file 
instead of a .BAK backup file. This allows for an extra 
level of backup. (This mode 4% not necessary on operating 
Systems that use fcle version numbers. ) 


. EQq types the text stored in Q-register q. 


(OS/8 TECO and TECO-11 use the :6q command to do this.) 


EXQ and EGQ are quick versions of the EX and EG commands 
respectively. They are much faster than EX and EG be- 
cause they don't mung over each character. Instead, they 
pad the current buffer with nulls, and then block for 

block copy the rest of the input file to the output file 
without looking at the characters. Nulls encountered later 
in the input file will not be purged. Presumably, these 
nulls will be purged the next time the file is edited. 


n,mStextS searches the text buffer between pointer 
positions n and m for the specified text. 


(This seems a bLt more Logical than the TECO-11 bounded search 


command. } 


EDfilespec$ inserts into the text buffer (at the current 
pointer position) a directory listing of the specified 
directory. Wildcards are permitted. If only-a single 
filename is specified, then this command does not do any 
insertion into the text buffer, but instead returns a value 
of -l1 or @ specifying whether or not the file exists. 


EKfilespecS deletes the specified file. 
(This capabslity 14 missing fom TECO-117.) 


EC core compression command. Causes TECO to relinquish 
any extra core that may have been obtained by expansion 
of its low segment. 

(A moze general command would be nEC which would tell TECO to expand 
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WPT TECO (cont.) 


8. EAprogram$ causes TECO to abort and — run the specified 
program. 
(This 45 not as generak as the OS/8& TECO EGcommands which allows 
an anbttrary monitor command to be executed. Naturally, 
EGr program$ 44 a valid TECO command. } 


9. EJ job information command. EJ returns the current job 
number. I1EJ returns the user's project,programmer number 
in the text buffer. n,mEJ does a GETTAB of n,m and re- 
turns the result. 


18. nP-has been changed to look for actual form feed characters. 
In. DEC's TECO, the nP command is identical to n<PWY> which 
is not quite the same thing, since the Y command might 
stop on buffer full rather than form feed encountered. 


11. The EZ and EO commands were removed. 


12. TECO may be initialized by a TECO.INI file. If a file 
named TECO.INI exists in the user's area, it will be read 
and the data in it (which must be in a particular rigid 
format) is used to load up TECO Q-registers. If Q-register 
@ is loaded by this scheme, TECO will perform an MZ 
command. 

(Because of the special format of the INI file, this method of 
Anitiatization 44 not as genenak as the scheme used by Stevens 
TECO which effectively treats the text in the .INI file as a macro 
to be executed. This method is also used by TECO-11 and will soon 
be used by OS/& TECO.) 


TECA 


TECA is a display version of WPI TECO. The meager information 
I have on it was received in January of 1977. It was written 
by Andy Nourse at DEC and is probably not in use at very many 
places outside of DEC. Some of its features are: 


1. It maintains a window into the text buffer and updates it 
after each command string execution. 


2. mnW command sets size of display window. 


3. V command takes same arguments as T command but moves 
the window to the specified text area. 


4. nt+ sets the terminal type. It can also be used to ‘set 
| terminal characteristics. 


5. All ASCII characters are legal Q-register names. Each 
Q-register has two parts and can contain both a text 
string.and a numeric value. 

(Having upper case and Lower case Q-negisterns be different is a 
neak Lose. } 
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STEVENS TECO 


This version of TECO runs on a DECsystem-]% and is based on 
DEC's TECO (version 23) for TOPS-18. It was written at 
Stevens Institute of Technology by John Ptochnak, Gary Brown, 
and Robert McQueen. The following information describes the 
differences between Stevens TECO version 123 and DEC's TECO 
version 23.0 It is accurate as of Sennen 197.6% 


1. The Y command has been replaced by EY. (Y still works 
within macros.) 


2% The ER and EW commands default ensoeeneiee fields from 
- corresponding previous commands. 


3. <A log-file capability has been added. ELfilespecs$ 
closes any previous log file and opens a new one. 
A copy of all TECO type-in and typeout goes into the 
log file. EX automatically closes the log file.. 
Switches such as /NOIN and /NOOUT are permitted to 
specify that only typeout (or only type-in) is to be 
logged. /APPEND appends to the log file. TECO macros 
can dynamically change log modes via an nELS command. 


4. ENfilespec$ renames the current input file to the name 
specified. ENS deletes the current input file. 


5. EDfilespec$ instructs TECO to run the specified program 
whenever TECO is exited. ED$ removes the pending run of 
such a program. 


6. :m,ntT allows TTCALLS to be executed. 


7. The EEfilespecS (Edit Execute) command saves the state of 
TECO in the file specified. Subsequent running of that 
file, causes this image to start up again. It continues 
executing commands that followed the EE command. 

(Several people have told me that this is an extremely useful 
command. It 4& somewhat mone convenient to use than the MUNG 
command. ) 


8. Commands such as ER, C, R, J, etc. can be colon modified 
and return a value of -1 for success and @ for failure. 


9. The EX command has been changed to act like the EXQ 
command of WPI TECO. 


18. The second CTRL/A in a CTRL/A command now forces-out the 
text. (Under DEC's TECO, terminal characters were buffered 
up until a line feed was output or the program terminated.) 


ll. Negative searches are permitted and cause the acorce to 
- proceed backwards. 
(most new TECOS ane allowing this. } 


12. m,nSstring$ searches for the specified string which must 
begin between pointer positions m and n. If m>n, then 
the search proceeds backwards. Bounded search also works 
for the FS command. 
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STEVENS TECO (cont.) 


13. 


14. 


15. 
16. 
Li. 


18. 


Lo. 


28. 
21. 
“hes 
23. 
24. 


2s 
26. 


EAfilespec$S (Edit Append) opens the specified file for 
update (appends at the end). 


Wq is similar to Mg but jumps to the Q-register. It 
stores nothing on TECO's internal push-down stack and 
does not expect you to ever return to the macro. level 
in which the Wq command is issued. It is useful for 
large TECO programs that are nested so deeply Eaae they 
might otherwise get PDL overflows. 


* is a valid Q-register name. 
EPfilespecS reads the specified file into Q-register *. 


EIlfilespec$ is the same as EPfilespec$M* executing the 
contents of the specified file. 

(This ib similar but not identical to TECO-11's EI command. The 
difference 4s that TECO-11 thinks the characters ane coming from 
the terminal, S50 certain characters will have their &mmediate 
effect as immediate action commands nather than as TECO commands. 
Fon example, under TECO-11, a CTRL/U tn an andirect file would 
erase the cwrrent command Line. 1 do not think that is good and 
I Like the Stevens TECO algorithm better. TECO-11 could be 
modified by setting a switch on an EI command to disable checking 
of immediate action commands (except $$) unti input returns to . 
a physical terminal. ) 


If a file by the name of TECO.INI resides on the user's 
area, TECO will EI this file upon startup. . 


The FDstring$S command searches for the specified string 
and deletes everything from the original pointer position 
to the new pointer position if the string is found. 
Bounded Find and Delete is also legal. 

(I have been told that this command may change to FK and that FD 
would mean delete the string that was found. ) 


Search failures now preserve the text buffer pointer. 
(This may be very conventent but will Rik existing TECO macros. ) 


The EC command will cause TECO to garbage collect and 
shrink to its original size. 


ntP pages out to page n. ntY yanks in text until page n 
has been read in. 


n,m= is the same as m= but then types out the character 
whose ASCII code is n. 
(The OS/& and TECO-11 ntT and n:= Seem mone useful. ) 


n,mtG performs a GETTAB UUO. 
ntF returns the terminal number being used by job n. 


Qq= types the text stored in Q-register q. 
(This would not work on TECO Stns that have split Q~ 
Negdstenrs. } 
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STEVENS/ TEXAS TECO 


is version of TECO (for the DECsystem-18) is based on Stevens 
WFCO version 123. It was written at Texas University by 
Clive Dawson. The differences between version 124 of this TECO 
and the original v123 Stevens version are described below: 


Ll. The CTRL/G<space>immediate action command was fixed so that 
it never types literally even if 1ET is set. 


2. ntG does a PEEK. 

3. i,j+tG does a CETTAB. 
“4. 4G returns your job number. 

5. ntF returns the TTY number of job n, -1tF is your TTY no. 
6 


. 4G. (bell-dot) immediate action command retypes the entire 
command string. 


7. The EB command always writes into your area and allows 
a /INPLACE switch to mean don't create a backup file. 


8. -n\\ and \\ are the same as n\ and \ but work in octal 
radix. (This does not appear to be as general as TECO-8'4 
and TECO-11'S general octal radix mode.) 


9. The linefeed, backspace, and semicolon immediate action 
-commands’ were implemented. If typed as the very first 
keystroke after TECO's prompt, they simulate the action 
of the - LT, -LT, and SLT commands respectively. 


“18. The EK command cancels any outstanding EW, EB, or EA 
commands. 


11. CTRL/Gq inside a string substitutes the contents of 
Q-Register gq into that string. 
(This proktferation of new special aati dn Search strings 
seems to me to be bad. It fust Lessens the number of characters 
that can be easily typed directly. I would prefer to see all new 
constructs be implemented as CTRL/E constructs and allow alk other 
controk characters to be Legak inside string arguments. } 


12. The /APPEND switch is allowed on the filespec in an EW 
command and converts the EW command to an EA command. 


13. The TECO monitor command can now have a /READONLY switch 
which causes TECO to perform an ER rather than an EB. 


14. CRT support. This version knows over a dozen types of 
scope terminals and handles command line scope editing 
correctly (rubout, backspace, CTRL/U, etc.) 

(Users of TECO-11 and TECO-8& abready know what a great boon this 

48. When you rubout a character, it neatly disappears from your 
Acheen. This feature works even when rubbing out ovscure 
characters Like tab and Linegeed. ) 


This version of TECO is widely in use in the field. There 

are probably between 5% and 19% installations using this 
version. It is available from Chive Dawson, Computation Center, 
University of Texas, Austin, Texas, 78712 for a nominal postage 
and handling fee. Send Clive a MAGtape (he'll write 9-track 88% bpi). 
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QUESTIONS anp ANSWERS 


This column will attempt to answer questions submitted by 
readers on any TECO-related topics. Our first set‘of 
questions were submitted by David Yost of Hollywood California 
and apply specifically to RT-11 TECO. 


Ql. 


Al. 


Q2. 


A2. 


Q3. 


A3. 


by David Yost. 


How do I reclaim the right brace, }, as a printing 
character? TECO seems to be translating it into an 
ESCAPE. | 


by Roy A. Auerbach (Texas. Tech University, Lubbock, Texas) 


Both the right brace and tilde (octal 175 and 176) are 
interpreted by RT-11 TECO as an ESCape. The file TECO.SAV 
may be patched to eliminate this. Address 124 from the 
bottom of TECO.SAV must be patched. The value of 22729 

at this address must be changed to 287. Running version 
28 TECO with RT-11 V-%3, my bottom address is 3756. 

A sample run to patch with my system would be: 


R PATCH 
TECO. SAV 

3756; QR 

B®, 124/ 22768 297 
E 


by David Yost 


Is there a way to get the text buffer pointer to stay 
where it is when a search on the current page fails? 


by Stan Rabinowitz 


Yes. In TECO-11, V28, the command @,nStext$ is exactly 
the same as the command nStextS except that it has the 
desired property that the pointer position remains 
unchanged after search string failure. This command can 
of course be colon modified so that you can detect the 
failure. 


by David Yost 


The manual I have refers to version 27 of TECO-11, but 
I have version 28. What do I do? 


by the editor 


Consult page 7 of issue number 1 of the Moby Munger for a 
complete list of differences between V27 and V28. The 
main enhancement was that Xqand tUq permit a colon modi- 
fier to mean append to Q-register instead of load. 


Queries should be submitted to the editor, Stan Rabinowitz, 
6 Country Club Lane, Merrimack, NH 03054. | 
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A NOTE ON THE EN COMMAND 
by Jim Burrows 


The EN comand, which allows wild-card file lookups is extremely 
‘useful, but at least on RSTS, has one drawback. on many disk 
structures the act of editting can change the order of the files in 
the directory such that the EN command will return some file names 
twice and others not at all. A simple coding technique can be used to 
“avoid this. . 


, Basically, the public structure on a RSTS system can span 
multiple ‘disks, thus editting a file can cause it to migrate from one 
disk to another changing the order of the directory. Furthermore, 
unless the NFF bit is set on a disk, new files are added to the end of 
the directory. Thus if you edit the first file in a directory, it 
becomes the last file in the directory and EN probably will find it 
later. 


For those not familiar with the EN command, I will briefly review 
its use. It takes a filespec arguement like the EB or ER commands. 
Rather than open a file, the filespec is used to perform wildcard 
directory look-ups. Subsequent invocations of EN without a filespec 
cause the name of the next file matching the spec to be loaded into 
the '*" pseudo-Qreg. Thus, if we execute the command: 


@EN"foobar.*" 


TECO will perform the necessary setup to allow it to find all files 


with the filename FOOBAR. Qreg * does not yet contain the name of a-- 


file at this point. To get the name of the first file, we must execute 
the COMMA: 


@ EN " w 


So far there is no problem. The name of the first-file matching 
Our wild-card spec will be in Qreg *. However, if we edit the file, 
say with the command: 


@EB" *EQ*" 


we may change the order of the files in the directory. a subsequent 
call will return us the name of. the second file which CURRENTLY 
matches the wild card spec. If we have indeed changed the order of the 
Files, the file that used to be the second may now be first, and we 
may get the file that was originally third. 


This problem can be avoided if we first gather the filenames and 
then edit the files. The follwing macro is an example of this 
technique. In it we will change all occurances of "DNDA" to "TMP:DNDA" 
in all files that match the wildcard spec "DND???.BAS". The list of 
Filenames is kept on the stack. The :] command is used to detect the 
end of the stack, and thus the macro will only work on versions of 
TECO which have implemented this feature. 
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A NOTE ON THE EN COMMAND (cont.) 


A note on the format of the macro. The author and several other 
programmers at DEC who do a lot of work in TECO, have adopted the use 
of a program to strip the comments and unnecessary whitespace from 
TECO macros to increase efficiency of the macro when executed. Thus 
the following conventions are used: 


1) All comments start with "Ie" and end with "*!" so that aney 
May be distinguished from labels. 


2) No literal strings contain CR or LF so that leading and 
trailing whitespace can be deleted on a per-line basis. 


LRREKKKEKKEKEKKKES | 


!* set up code *! 
PRAKKKRKEKKEKKEKRKER 


<:J1l;> !* Clean off the stack *! 
@EN"DND???.BAS" !* Initialize the wildcard look-up *! 


PRA EKKKKEREKEKKEKKEKKEKKEKEKEKEKEKES | 


!* First get the file names *! 
PRARRKEKKKEKEKKEKKEKEKEKEKKEEKKEEE | 


<@:EN"": . !* Get first file name into Qreg * x! 
G* “yXl “YK [1 !* Get it in memory, push it, delete it. *! 
> !* And do it again, till the :EN fails *! 


PRARKKKKKRKKEKKEKKEKKEERKEKEKES | 


!* Now go do the edits. *! 
PRR EKKKRKKEKKKEKKEKKERKEKEKESE | 


<:]l; : !* Pop the first name off the stack. *! 
@EB"” EQ1" !* Edit (indirect) the file *! 


<@FN"DNDA"TMP:DNDA";V>!* Do the edit throughout the file *! 


EC !* Close the file *! 
@“A" Done with " :Gl !* Tell ‘em what you did *! 
13°T 10°T '* Return the carriage *! 
> !* Go back and get the next file *! 
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TECO MACRO OF THE MOWTH 


This macro creates a distinctive IN USE message on a user's 


display terminal. 


screen, 


It prints a user message on the top of the 


ticker-tape fashion. 
ET#HIET. “A$H$J 


a é 


it prints IN USE in block letters in the middle, and 
it displays a canned message at the bottom of the screen in 


Z"N°A 0 wee w= “A ' HT Z"N*A 9 <----- “A ' HK “A 
ITIIII NN NN UU UU 8558588888 EEEEEEEEEE 
PLE IT NN NN UU UU SSSSS8S8SS_ EEEEEEEEEE 
nig NNNN NN UU UU SS EE 
Il NNNN NN UU UU $88 EE 
TT NNNN NN UU UU SS EE 
Ee NNNN NN UU UU SS EE 
1 ae NN NN NN UU UU 9558858 EEEEER EEE 
Il NN NN NN UU UU SSSSS58 EEEEEEEE 
id NN NNNN UU UU SS EE. 
II NN NNNN UU UU ss EE 
Il NN NNNN UU UU oo EE 
II NN NNNN | UU UU So. BE | 
IITIiitl NN NN ; UUUUUU 55588558 ELELEEEBEE 
LILI NN NN UUUUUU 95555555 BEEEEEEEEE 


cn use by TECO fanatic John Doe 


“A 


IThis.- terminal is presently in use. $ 

IUnfortunately, I am forced to leave my post for a short period of time. 
II will be back soon. $ 

IWoe unto him who steals my terminal during my absence. $ 

IThe security of the whole free world depends upon my accomplishing my $ 
Iduties at this terminal. $ 


IUnder no circumstances is this terminal to be used by anyone $ 
Iwithout my permission. 


OU1 0,80XA ZJ GA J 

€Q1,Q1480T %21-Z24+79"E1U1' “AM AD 
Gor e 
$$ 


where @ denotes a CR (with no LF) 


runs under all DEC operating systems. On some 
is first necessary to set up the terminal with a 
SET TTY NO CRLF command or its equivalent. It is run from 
RSX, RSTS, IAS, OS/8, VAX, and RI-11 via the command 

MUNG INUSE,message where "message" is any user message. It 
is run from TOPS-1%8 via the commands: R TECO 

*ERINUSE. TECSYHXZHKImessageSMZ$s 


This macro 
systems it 
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COMPATIBILITY CORNER - by Stanley Rabinowitz 


The following TECO commands are identical on TECO-11 v29, 
OS/8 TECO v5, and TOPS-18 TECO v24, or have only slight 
incompatibilities: 


ER EW EB EF EX A Y P PW e 
R ie I nis 4#I  n\ . = . i 
& # (n) T tA = =<= 447 =D K B 

; ; H S N _ FS FN: @ 
OR +F +H +ttx <n> ! O "hp 9G MY, 
"N: oS Ls ae a 8 % x Qo Gc M +E 


+N EH EU 


In addition to the above, the are a large number of other 
features that are compatible, such as the immediate action 
commands, the-execution time commands, and the match control 
constructs. 


Also, there are a large number of commands on each operating 
system that are extensions to TECO, but are not incompatible 
with each other. 


In: the last issue of the Moby M., we listed a set of com- 
patibility issues that are yet to be resolved. No one sent 

in any comments. These issues and their results are described 
below. Note that many of these issues have already been 
resolved; and many cannot be resolved until the -1 group is 
ready to re-release TOPS-1f% TECO. Notation: $ denotes an 
ALTMODE and (*X) represents the single character CTRL/X. 


Implementation Dependent Date 


Problem: The (*B) command returns an implementation- 
dependent value. 


Discussion: It is unlikely that the user really wants 
the date in a strange encoded form. 
He will probable decode it first thing. 
Proposal (a) below incurs a possible race 
condition around midnight of New Year's Eve. 


Proposals: (a) Replace (*B) with n(*B) command. 
Arguments as follows: 
1(*B) returns year (0-1999) 
2(~B) returns month (1-12) 
3(*B) returns day (1-31) . 


(b) Have (*B) insert the date 

into the text buffer as a character 
string. 

(c) Leave (*B) as system dependent. 


Decision: issue still pending 


Implementation 


Problen: 


Discussion: 


Proposals: 


Decision: 
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dependent time 


The (*H) command returns an implementation- 
dependent time of day. 


internal word size of -11 cannot store 

number of seconds in a day. 

Proposal (a) below incurs a race condition. 

If at 4:59:59 a program accesses the hour and 
finds it to be 4 and then the program accesses 
the minute and finds it to be 00 (since it is 

now 5:00), the program will incorrectly think the 
time is 4:00 when it is actually 5:00. 


(a) Replace (7H) by n(*H) command 
with arguments as follows: 
1(*H) returns number of hours since 
midnight (0-23) 
2(*H) returns number of minutes since 
last whole hour (0-59). 
3(*H) returns number of seconds since 
last whole minute (0-59) 
4(*H) returns implementation-dependent 


number of ticks since last 
whole second.: 


.(b) Have (*H) insert the time as a 
character string in the text buffer. 


(c) Leave (“H) to be system dependent. 


~issued still pending 


Incompatible form feed command 


Problem: — 


Discussion: 


Proposals: 


Decision: 


The (*L) command is- ignored on -8 but 
prints a form feed on -10 and ~11. 


~10 use of (*L) can be performed by the 
equivalent command (*A)(*L)(%A) 


f(a) change ~8 to conform with -10 and -11. 


(b) Change -10 and -11 to conform with -8. 


It was decided that the -8 should conform. 
OS/8 TECO was changed to conform as of v5. 
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Radix control problem 


Problem: 


' Discussion: 


Proposals: 


-8 and -11 allow TECO to work in two modes 
(octal radix and decimal radix mode). The 
current mode of TECO affects many commands. 
The -10 does everything in decimal, except 
for a few commands, and treats (“0O) as 

a modifier for numeric strings. 


Octal mode seems-more important on small 
machines. 


(a) change -10 to conform with -8 and -11. 


(b) Change -8 and -11's (*0) and (“D) 
to (*0)$ and (*D)$ 


(ce) Change ~-8 and -11's (70) and (“D) 
to’ C°O)CO) and (DICD). 


(d) Define a bit in the ED flag, such that 
if this bit is set, (*O) and (“D) 
will only apply to the next digit string. 


(e) Make the 0(*R) command mean that future 
occurrences of (*0) and (*D) only apply 
to the next digit String. 


Decision: Issue still pending. 
Obsolete use of (“R) 
Problem: On -8 and -11, (*R) is a redundant command, 
having the same meaning as FS. 
Discussion: (*R) was implemented before FS was implemented 
on -10. Then FS was put in for compatibility 
with -10. (*R) was kept for compatibility with 
old -8 versions of TECO. 
(*R) is easier to type than FS (?). 
Proposals: Jf Remove (*R) command from -8 and -11 
to free up character for future use. 
(b) Leave duplicate command in 
Decision: It was felt that (*R) was an unecessary command. 


(*R) is no longer in TECO-11 or OS/8 TECO. 
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Incompatible (*V) command 


Problem: 


Discussion: 


On the -10, (*V) is used to go into ‘translate 
to lower case' mode. On the -8 and -11, 
(“V) returns TECO's version number. 


letters V and W are firmly locked into lower 
and upper case mnemonics on -10. 

(*V) on -8 and -11 is not a critical command, 
unlikely to change running of old macros. 


Proposals: fia Change (*V) command on -8 and -11 to 


Decision: 


EO command. For next release on -10, 
upgrade EO value to -10's TECO version 
number (e.g. 23). 


(b) Change (*V) on -8 and -11 to EV. 


(*V) and (*W) are heavily used on the -10 
and should not change. (*V) on the -8 and 
-11 is not a crucial command and EO would 
be just as useful. 

This change was made to OS/8 TECO as of V5. 
This change was made to TECO-11 as of v29. 


‘Incompatible (“W) command 


Problem: 


Discussion: 


Proposals: 


Decision: 


On the -10, (*W) is used to go into ‘translate 
to upper case' mode. On the -8 and -11, 


(*W) is used to force a display update on 


scope displays. 


Both uses are very common on their respective 
machines. 

-11 will eventually want to support 

upper and lower case, however, they're not 
Sure they like the -10's syntax. 


Jia Change (*W) on -8 and -11 to WwW. 


(*W).is needed by the -10. On the -8 and -11 


it is only used by scope TECOs and could 
more easily change. PW would be considered 

a Single 2-character command and therefore 
should not be confused with the two commands, 
P followed by W. 


(*W) was changed to W in OS/8 TECO v5 and:’in 
TECO-11 v29. 
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Incompatible (*Z) command 


Problem: 


Discussion: 


Proposals: 


Decision: 


Space problem 


Problem: 


Discussion: 


Proposals: 


Decision: 


On the -10, (*Z) causes return to operating 
system after finishing I/0 and closing 
output file. On -8 and -11, (*Z) returns 
total number of characters in Q-register 
storage. 


-8 and -11 usage of (*Z) is not very critical. 
-10 changed (°G) command to (*Z) for EO 
level 2, -8 still- uses (°G). 


' The (*Z), alias (*G) command is very dangerous 


and can be accomplished by the equivalent 
commands: EFEX. Use of (*Z) as an immediate- 
mode command is a different issue. 


(a) change -8 and -11 usage of (“%Z) 
to some other command. 

(b) switch (*Z) back to (7G) on -10. 

(c) Remove -10 use of (*Z) from TECO 


and -8 use of (°G). 


OS/8 TECO removed the (*Z) command as of v5. 
However, issue is still pending. 


On the -10, spaces are normally ignored, 
however, between digits, space is treated 
as plus. On the -8- and -11, spaces are 
ignored everywhere. 


-10 use of space is traditional (but ugly). 
Ignoring spaces everywhere is more consistent. 


(a) change -10 to ignore spaces everywhere 


(b). change -8 and -11 to treat space as + 
in certain constructs . 


(ec) change all systems to give error message 
if space appears within digit string. 


It was decided that proposal (a) seems best, 
however issue is still pending. , 


10. 


11. 


trea 
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Incompatible "A command 


Problem: On -10 and -11, "A is an ‘execute if alphabetic! 
command. On ~8, n=-m"A is an ‘execute if 
n>=m' command. 


Discussion: -8 usage was implemented before -10 usage 
came along. Normal compare conditionals 
such as "N, "L, ete. do not always work 
on the -8 because the ~8's maximum number 
(unsigned) is 4095, yet the -8 allows almost 
4000 characters (maximum) in buffer. 
When comparing buffer pointers, for example, 
anomalous results can occur with "L command 
Since it requires a signed argument whereas 
the . command produces an unsigned value. 
This was gotten around by creating the after 
and before commands ("A and "B) which check 
the link instead of the sign bit. This is not 
a problem on the -10 and -~11 because of their 
increased word sizes. 


Proposals: (a) Change "A and "B- commands on -8 to 


"< and "> 
Decision: OS/8 TECO removed "A and "B commands as of v5. 


The problem was gotten around by increasing 
OS/8 TECO's arithmetic precision to 13 bits. 


Definition of alphanumeric character 


Problem: The "C command needs to know what an. 
alphanumeric character is. This concept 
differs between implementations, 
Are the character ., $, %, etc. 
alphanumeric? 


Proposals: J Allow this command to be machine dependent. 
Decision: It was decided that this command ‘needed to be 
machine dependent to allow users to search 


assembly sources for symbols. 


GeneralizAtion of % command 


Problem: The -8 and -11 generalized the % command so 
that the argument is added to the specified 
Q-register. On the -10, n%Zq always means 1%q 


Discussion: Code 'fell out' on ~8 and -11 implementations. 


Felt to be a very useful extension. 


Proposals: . (a) Change -10 to conform with -8 and -11. 


WP nee. Hee Sse a) -_-h 2141 14 wanwnA aun 


13. 


14. 
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Unspecified repeat counts for iterations 


Problem: 


Discussion: 


“Proposals: 


Decision: 


= problem 


“Problem: 


Discussion: 


Proposals: 


Decision: 


If no repeat count is specified for an 
iteration, each implementation uses a 
different default value. 


Largest number in machine was a likely 
default. 


(a) keep this default to be implementation- 


dependent. 
J 6») Change all implementations to make the 


default truly infinite. 


It is beleived that proposal (b) is easy to 
implement and will give users what they 
really want. 

All DEC TECOs now treat an unspecified 
iteration count as being a truly infinite count. 


= and == do different things on various 
implementations. On -11, they reset the 
radix, on -8 they do not. On -8 

they print unsigned values, on -10 and ae a 
prints signed value. 


There is no great need to be able to 

print a value in the current radix (as the 

-8 does) without knowing what the-radix is. 
However, I can see cases where a macro may want 
to do something in a given radix, and then 
return to the user in the original radix. 


f(a) Have standard say that == prints the 


value in octal and does not change the 
current radix. = prints the value in 
decimal and does not change the current 
radix. ' 


It was felt that most of the time (except 
occasionally on the -8), the user wants to 
see signed numbers. Thus = should print 

a Signed value. The fact that the -11 == 
reset the radix was conSidered a bug and 
has been fixed long ago. 


15. 


16. 
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Generalized nA command 


Problem: On -10, nA is always the same as OA on the 
-8 and -11. 
Discussion: '-8 and -11 generalization is fairly obvious. 


-10 users may be locked into current use, 
especially since user's might use 1A instead 


of OA. 
Proposals: (a) change -10 to conform to -8 and -11 
| during next EO level. . 
(b) change -8 and -11 to conform to -10. 
Decision: Problem is still pending. 
Location of @ | 
Problem: -10 manual claims @nS/text/ is legal 


but n@S/text/ is not. 
-8 and -11 manuals claim cine reverse. 


Discussion: In point of fact, both are legal on all 
- implementations. Furthermore, @ is merely 
.a modifier and need not be immediately 
adjacent to the search command. It may 
appear anywhere and merely affects the 
outcome of the next search executed. 


Proposals: (a) modify all documentation to describe 
. actual behavior properly. 


(b) pick a syntax and modify all 
implementations to use it and give 
error messages for all other uses. 


(c) ~— |. Require @ to be first character ofa 
2 or 3 character command. Thus @ 
may not occur alone, and must immediately 
be Tollowed by Sj. N,:..¢ FS, FNg or Fo 
Furthermore, : may also not occur alone, 
it must immediately be followed by @ 
or one of the above forms. 


W ACD Ignore this issue. 


~ Decision: Problem seems too trivial to bother with. 
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Filespecs treated as text 


Problem: -~11 treats filespecs as text and allows 
it to contain special characters (such as 
(*E)Qq ) and allows it to be modified by 
@ modifier. -8 and -10 do not permit this. 


Discussion: -11 usage is a nice generalization and 
causes all text-like occurrences to be 
treated uniformly. 


Proposals: (a) Change -10 and -8 to conform to -11 


Decision: OS/8 TECO now (v5) allows filespecs to be @-sign 
modified. Issue is still pending. 


EH value is implementation dependent 


Problem: The meaning of the value of the EH 
flag is implementation dependent. 


Proposal: Ja Change TECO-11's 3EH to 4EH to prevent 
conflicting with -10's 3EH. Reserve 
3EH on -11 for future use. 


Decision: TECO-11 (v27?) changed EH so that 1, 2, and 3 EH 
. are compatible with the -10 (although 3EH is not 
implemented). The 4's bit in the EH flag is an 
extension to TECO on the -11. 
OS/8 TECO implemented the EH flag compatibly 
with both TECO-11 and TOPS-10 TECO. 


wor 
w 


ET value is implementation dependent 


Problem: The value of the ET flag is implementation dependent. 
Decision: Issue is still pending. 


Closing of files with EW 


Problem: On the -10, EW closes the current output file. 
On the -8 and -11, EW creates a new output 
file and the old one is not replaced by the 
partially created temporary file. 


Discussion: Both algorithms seem pretty poor. 


Proposals: . (a) Change all systems so that EW gives an 
error message if an output file is already open. 


Decision: TECO~11 quite a while ago implemented proposal (a). 
OS/8 TECO and TECO-11 also implemented the EK 
eommand to 'kill' or take back the effect of an 
unwanted EW. Issue is still pending. 


ets. 


2e. 
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Required altmode on nI 


Problem: 


Discussion: 


Proposals: 


Decision: 


the -8 does not require the altmode 
at the end of the nI command. It is 
required on the -10 and —-11. 


$ was optional on -10 during EO level 1. 

The $ is necessary in order that this command 
can be correctly parsed and skipped over when 
encoutered in an unsatisfied conditional. 


f(a) make $ reguired on -8 


(b) Make $ optional on -10 and ~-11. 


Proposal. (a) was picked, however, due to space 
and time limitations, OS/8 TECO may not implement 
the necessary error checking in the near future. 
Users should always put ALTMODES after an nI command. 


Passing values through Macros 


Problem: 


Discussion: 


Proposals: 


Decision: 


the -8 and -11 allow arguments to be passed 
to macro calls. They allow macros to return 
values. Both are specifically prohibited 

on the -10. a 


Macro arguments and values are as useful in 


TECO as functions are in FORTRAN, BASIC, and 
ALGOL. 


. f(a ' Change -10 to conform with -8 and -11. 


It was found that TOPS-10 TECO v24 already conforms 
to this decision (proposal a), however their 
documentation didn't make this fact clear. 


Negative arguments to searches 


Problem: | 


Discussion: 


Proposals: 


Decision: 


The -11 allows the argument to certain search 
commands to be negative. This causes the 
search to proceed backwards on the same page. 


This is a most useful and consistent extension. 

(a) Change ~10 and -8 to conform to -11_ 

(b) Leave status quo, call this a compatible 
extension and not an incompatibility. 
Change error message on -8 and -10 to 


read "feature not implememented" 


Issue still pending. 


a4. 


25. 


27. 
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Strange W command 


Problem: 


Discussion: 


Proposals: 


Decision: 


The W command is illegal on the -10 and -11. 
It is ignored on the -8. 


This is probably a bug in -8 implementation. 


(a) Change -8 to treat W command as 
an illegal command. | 


Problem went away after issue 7 was resolved. 
W is now a valid command on -11 and -8. 


Alpha and Numeric Q-registers 


Problem: 


~ 


Proposals: 


Decision: 


-8 and -11 have two storage compartments in 

each Q-register; one to hold strings and 

one to hold numeric values. Both can retain 

their values simultaneously. On the -10, 

if a string is stored in a Q-register which 
previously contained a number, this number is lost. 


(a) Document around this problem. Have the 
"standard' say that if a number is stored 
in a Q-register, and then the Q-register 
is read by a command requiring an alphabetic 
string, the result is unpredictable. 

(b) Modify -10 to have 'split' Q-Registers. 

(c) Treat -10 as subset of 'standard' TECO. 


Issue is still pending. 


Concatenated commands which return values 


Problem: 


Discussion: 


Proposals: 


Decision: 


If two commands which return values are 
placed next to each other, the result 
is not the same on all implementations. 


For example, if there are 5 characters 

in the buffer, then the command Z3= 

produces 3 on the -10 and 53 on the -8. 

This is probably a bug in the -8 implementation. 
The -10 impementation ain't that swift either. 


(a) Pick a scheme and have everyone conform. 
(b) Treat this as an error. . 
(c) Declare action to be undefined. 


Issue is still pending. 


28. 


29. 


30. 
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Checking for erroneous number of arguments 


Problem: The ~8 and -11 do not give errors for 
commands of the form 3,5,6D or 2,5L 

Discussion: The -8 and -11 use the last values typed. 

Proposals: (a) Change -8 and -11 to give meaningful 


error messages in the following 2 cases: 

(a) more than 2 arguments are typed 

(b) two arguments are typed to a command 
which allows 1 but not 2 arguments 


(b) Declare action to be undefined. 
Decision: OS/8 TECO now gives an error (?ARG) if three 
numeric arguments are specified with any. 
command. Issue is still pending. 


End-of-line character 


Problem: The -10 treats any vertical paper motion 
e, character as an end-of-line terminator. 
The -8 and -11 treat <LF> only as end-of-line. 


Discussion: -10 changed from -8 and -11 interpretation during 
EO level 2. 

Proposals: J (a) Change -8 and -11 to conform to =-10. 

Decision: Both OS/8 TECO and TECO-11 now treat line-feed, 


vertical tab, and form feed as end-of-line 
terminators, in accordance with the -10 


implementation, 
Echoing of Bell | 
Problem: On the +10 and -11, the character (*G) echoes as 
“G(*G). On the --8, it merely echoes 
. as “G. . 
Proposals: J (a) ‘Change ~8 to conform with -10 and -11. 
Decision: OS/8 TECO now rings the bell as well as types "*G" 


as of v5. 
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FUTURE COMPATIBILITY ISSUES 


Readers are urged to send in comments, criticisms, and 
suggestions concerning the preceding compatibility issues. 
In future issues of the Moby Munger, we will go into 
detail about other compatibility problems. In order to 
give readers a chance to comment on such issues in advance, 
we print below the titles of some future issues: 


31. *Z is CTRL/S on PDP-8 

32. Vertical tab command 

33. Partial error reporting with ? 

34. Assumed : modifier for searches in iterations 
35. F modifier on PDP-8 

36. Label tracing in conditionals 

37. Carriage return input to CTRL/T 

38. echoing of NULL 

39. Matching of begin of buffer on CTRL/S 
48. $S command 

41. Jumps to left out of -iterations 

42. == signed on PDP-19 

43. Memory expansion algorithm 

44, Forced exact mode searches 

45. CTRL/C command 

46. Passing arguments through [ and ] 

47. Case flagging on lower case terminals 


Readers discovering other compatibility problems amongst DEC 
TECOsS are strongly urged to report them so that they may be 
discussed in future columns. 


TECO TECHNIQUES - How to Write Printable TECO Macros 


Many PDP-11 operating systems have the problem that their 
line printer drivers (and sometimes even their terminal 
drivers) do not print visible symbols to represent the entire 
ASCII character set, or even a large percentage of the ASCII 
set. 


In particular, when making listings of TECO programs, it is 
“necessary to see all the control characters and ESCAPEs in | 
the source listing. To get around this problem, TECO-11 has 
generalized the TECO language so that all TECO programs can 
now be written using only printable characters. In the table 
below, we show how to write printable equivalents of typical 
commands: 


Traditional Command Printable Equivalent 
CTRL/X 4 
Sabcs$ @S/abc/ 
nis Q@nI// - 
$ . | + [ 
ERfiles @ER/file/ 
<TAB>xyz$ Q@tI/xyz/ 
@I/S/ @27I// 
Otag$ @O0/tag/ 


CTRL/X in a string +X in the string (with MED) 
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TECO-RELATED DECUS SUBMISSIONS 


The following items of interest to TECO users are available 
from the DECUS program library: 


Number 


DECUS-8~-863 


DECUS-L-125 


DECUS-19-264 


DECUS-18-229 


Description 


TECO Overlay for VC8/E. 


PATCH 


ATEC 


Submitted by M. Boudinot. This is an 
overlay to OS/8 TECO (version 3) to 
allow it to display a window into the 
text buffer on a VC8/E display. It is 
written in PAL8 and makes the VC8/E 
look like a VR12. The write-up of the 
algorithm is quite detailed. 


TO OS/8 TECO FOR LINC-8 DISPLAY. 


Submitted by Mark Lewis. This is an 
overlay to OS/8 TECO (version 2) to 
allow it to display a window into the 
text buffer on a LINC-8 display. It is 
written in PAL8. 


Submitted by Jack Krupansky and Mark 
Crispin of Stevens Institute of Tech- 
nology. It was written from scratch in 
MACRO-19. XTEC is a TECO compiler for 
the DECsystem-1%9. It is much faster 
than DEC's TOPS~-198 TECO since it 
actually compiles command strings and 
macros into hard code. In general, it 
is. upward compatible with TOPS-19 

TECO version 23. 


TOPSTEACH 


This was written by Jacob Palme and is 
an automated course which introduces you 
to the TOPS-1% operating system. It is 
of interest to TECO fans because there 
are several segments which are TECO 
tutorials and this course makes a fine 
introduction to TECO for a novice. 
Unfortunately, it will only run ona 

-18 since it is written in the GNOSIS 
language (a language designed for 
computer-aided-instruction), however 

I have looked at the source and it would 
not seem to be too hard to write a 
GNOSIS compiler in TECO if anyone were 
interested. 


' Dot to Mark if 
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TECOs AVAILABLE FROM DECUS 


Operating System DECUS ‘Order Number TECO version’ 


RT-11 DECUS-11-288 TECO-11‘v28 
RSX-11/M DECUS~11-333 TECO-11 v28 
-RSX-11/D, IAS _ DECUS-11-334 TECO-11 v28 
DOS-11 DECUS-11-265 ~ TECO-11 v15 
RSTS/E DECUS-RSTS-11-195 TECO-11 v24 
TOPS-19 DECUS-18-264 ©. XTEC %@ (427) 


Trhese submissions are updated from time to time. 


BUGS IN TECO-11 


Only one bug in TECO-11 has been reported since the last 
issue. Either TECO-11 is extremely solid, or no one is 
reporting the bugs. Bugs should be reported to the TECO 
SIG, care of DECUS. 


$ bug in v32 


The $ (ESCAPE) command is supposed to discard any numeric 
arguments. However, the command in all versions of TECO-11 
up to v32, is forgetting to reset the comma flag, that 
indicates that a comma has been seen. Thus, a command such 
as H$T acts incorrectly. HST should be exactly identical 
to T, however, it isn't. It does unpredictible things, 
like @,.T or something. This bug will be fixed in v34. 

In the meantime, avoid using two arguments to a command 
that doesn't expect two arguments. 


7? VTEDIT MACRO for TECO-11 


(E8C] “A Append [No FF] text * 
{ESC]“B Delete [next] word* 
“D Kill rest of line* 
(ESC) “Eq Execute [iterate] Q-reg q* 
“F Forward over word*} 
“Gq Get text from Q-reg g 
*K Kill linetf 
(Z8C]*N Non-stop [destructive] search* 
“R Back over word*t 
“Ti:Jq Cut text to Q-reg qg*t 
“U Kill start of line 
“V Toggle display mode 
“W Set line* /re—paint 
“Ni:lq Save text in Q-reg q*t 
“Y Yank next page* 
“\z' Insert ASCII fxr” 

BK &P Go to end of line* 
DELET® Delete previous character* 
ESC RSC Repeat RED-key command* 

HSC ¥F Find front of file 

a cee an ESC H Display help frame 
"C{orJ°Z Return to TECO ESC MM Set left margin* 

ESC °Z Exit from TECO ESC N Get next word* 
ESC-°Z Kill output, exit ESC T Select word delimiters* 


Type any key to 
resume editing. 


All * commands 
take an optional 
argument as: 
HSC oxpree- 
sion key (a) 


All ¢ commands 
operate fromm 


Mark is set 


All ¢ commands 
gare continuous 
when entered as 
KSC kay. (Type 
any key to 
stop.) 


DECUS 


DIGITAL EQUIPMENT COMPUTER USERS SOCIETY 
ONE IRON WAY, MR2-3/E55 
MARLBORO, MASSACHUSETTS 01752 


MOVING OR REPLACING A DELEGATE? 


Please notify us immediately to guarantee continuing 
‘receipt of DECUS literature. Allow up to six weeks 
for change to take effect. ; 


( ) Change of Address 
( ) Delegate Replacement 


DECUS Membership No.: 
Name: 
Company: 


Address: 


State/Country: ___- 
Zip/Postal Code: 
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Mail to: DECUS - ATT: Membership 
One lron Way, MR2-3 
Marlboro, Massachusetts 01752 USA 
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